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D I SCLA I MER 



Joseph Ross, the sole author and distributor of cSHELL99, referred to as 
the "product 11 ! does not guarantee that this product or manual will be free 
from error f or meet the needs or expectations of the user. 

The author is not liable for the use or misuse of this product or any damage 
that may result from the normal use of this program, proper or improper use 
of this product or any information contained within this manual. 

The author warranties the product diskette for a period not to exceed 90 days 
from the purchase date provided the diskette is not damaged from improper 
use f accident, or any condition not due to the quality of the material or 
workmanship. The author reserves the right to refuse to service any returned 
materials that do not meet this qualification. 

If there is a diskette problem that meets the above conditions, send the 
original diskette only to the author and a free replacement will be issued to 
the user. 

Because of the nature of the cSHELL99 product, the product is provided 
without any copy protection. This is not a license to distribute this product. 
The product and manual are copyrighted by the author and may not be reproduced 
by any means for the use of others. If the user transfers ownership to another 
all personal copies must be transferred or destroyed. It is the owners 
responsibility to control its use and distribution of personal copies. Owners 
who disregard this responsibility are liable for any damages incurred to the 
author due to the loss of sales. 

Support for cSHELL99 will be in direct proportion to the response for the 
product. All comments and product suggestions are welcome and should be 
forwarded by mail to the author. In the near future I plan to create numerous 
companion modules that will be offered at a very reasonable price. Also 
in the works is two versions of the product that will take advantage of the 
Super Space & Super Spacell memory cartridge by DataBiotics Inc. 

MANUAL: Copyright 1989 - Joseph Ross 
PROGRAM: Copyright 1989 - Joseph Ross 
PRODUCED BY: 

Joseph Ross 

119 Knoll wood Terrace 

Clifton, New Jersey 07012 

ALL RIGHTS RESERVED. 

Purchase price $30.00 US funds. 

Copies of the "cSS" compiler may be purchased from: 

Clint Pulley 
38 Townsend Avenue 
Bur 1 i ngt on , On t ar i o 
Canada L7T 1Y6 

At last information the purchase price was $20.00 . 



FORWARD 



CSHELL99 is a window oriented DOS type program similar in appearance 
to "GEOS" for the Commodore 64. It was developed as a personal project 
of the author for use on the TI 99/4A Home Computer. Unlike GEOS and other 
Macintosh type systems f cSHELL99 does not operate in a bit mapped mode but 
rather in text mode. This was done to utilize the VDP RAM for window 
displaying routines and enable the use of various loaders which are vital 
to the program. It also contributes to the speed of the windows and 
greatly reduces the overhead needed to run the system. 

CSHELL99 is written in a mix of assembler and "cS3" created by Clint Pulley 
of Ontario f Canada with all of the assembly language routines being placed 
within a C structure. Some of the routines will have their source code 
included so that the user may take full advantage of and expand the 
basic system. 

The purpose of cSHELL99 is to provide the 99/4A community with a slightly 
different and fun environment in which to operate. It is n ot in t ended to 
r eplace the many f ine pieces of sof tware already in the^^mut^ty ^but to 
demonstrate additional power of a great machine. In the main programs 
DESKTOPf there are many file and disk oriented features along with system 
configuration windows and program loaders. The main power of the system shelly 
is the use of the loaders which allow programs written in "c99" to be run 
from the shellt execute and return back to the shell environment thus enabling 
the user to add features they desire. The documentation provided describes 
in-depth the system's features, use of loaders, "c" stacks REF/DEF table, 
system functions and global s available to the user. Interfacing with 
cSHELL.99 is a rather easy process for both experienced and beginning "C" 
programmers as you will see when you read the documentation. Simple examples 
of interfacing have been provided to aid in this process. The loaders used 
are the two standard loaders used in the Ed/Assm environment! option #3 
Load and Run and option #5 Program Image. 

Also included with the cSHELL99 package is a c99 sound library which is similar 
to the Basic CALL SOUND command, The source code to a c99 graphics library, 
a c99 speech library and many modules that demonstrate the ability of c99 
to execute text, graphics and bitmap modes. 

I believe you will find cSHELL99 a most interesting and enjoyable environment 
in which to operate. With the tools and information provided, you will soon 
discover that the limits of the TI 99/4A are not 32K but your imagination. 



Enjoy, 
Joe Ross 
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The equipment needed to run CSHELL99 is as follows: 

TI 99/4A Home Computer 

PE Box or the equivalent 

32K memory expansion 

Disk controller and disk drive 

Editor Assembler module. Extended Basic or 

TI Writer module 

Optional but desirable: 

Additional disk drives 
RS232 card 

- 

Printer 

Joystick #1 or trackball 

If you have received cSHELL99 on SS/SD flippy disks, place the 
SUSTEM disk side A in a drive and follow the loading procedure. 
When the program has loaded, turn the system disk to side B to 
access the desktop modules. 



LOADING 

To run the program, select option #5 from the Editor Assembler main 
menu and type DSK#.UTIL1 or just press ENTER if the system disk 
is in drive #1. 

From Funl writer select Loaders and choose the Program loader. 
Type DSK#.UTIL5 and the program will load and start running 
in the Desktop screen. 

To load from the Extended Basic cartridge, choose Extended Basic 
from the selection screen and the program will automatically 
load and run if the system disk is in drive #1. Else type 
RUN DSK#.LOAD . 

To load from the TI Writer module, select Utilities and press ENTER 
if the system disk is in drive #1 or type DSK#.UTIL1. 

NOTE: The Alpha/Lock key must be in the UP position if using the 
joystick. 
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Desktop - ■ ■ • A. 1 

Module Auto Running B. 1 

Linking Loader C. 1 

Creating Program Image Files............. D. 1 

cSHELL99 System F unctions E. 1 

CSHELL99 Window Functions. F. 1 

Window Globals G. 1 

Companion Modules. H.l 

Screen Dump Module 1. 1 

Sound Library... J.l 

Speech Library......... K. 1 

Low Memory Usage AP. 1 

VDP Memory Map.. AP.2 

FILE I/O Errors AP.3 

System Globals AP.4 

c99 Stack AP.5 

Desktop Character Definitions AP.6 

AcJcJ^cJ Doc umentat ± on 



Source code and additional information on MODULES DISK 
sides 8 and D. 
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Blank windows are multiple purpose windows. 



DESKTOP 



CSHELL99 starts in what will be known as the DESKTOP environment. 

From the DESKTOP the user may access all the program modules and system 

utilities via dialog boxes (windows) and icons. To activate any icon or 

dialog box, place the pointer (arrow) on top of the desired selection 

by using joystick #1 and CLICK (press the fire button on the joystick). If 

a dialog box is activated, a window will appear displaying a menu. To select 

an item from the menu f pull or push the joystick forward or backward till the 

desired selection appears in inverse video f then CLICK once. The result 

of selecting an item from a window menu will be to execute the selection, 

prompt for input or display another window menu. If no item from the window 

wenu is desired, move the joystick till the inverse video disappears and 

CLICK. The window will close leaving the pointer in its previous position. 

When an icon (pictorial representation) is activated a predetermined action fy\&<ju& \ 

or message is the result. (yud&V^* 

NOTE: The arrow keys may be substituted for the action of the joystick 

in both^ moving the pointer and choosing a selection from a dialog box menu. 

The "Q^ key may be used instead of the joystick fire button. 



DESKTOP WINDOWS/ICON ACCESS 

The desktop windows are accessed by placing the pointer on the desired 
title (System, File, Disk, Special) and pressing the fire button on the 
joystick. A window will open on the screen as a menu ready for your 
selection. Pull/push the joystick untill the desired option appears in 
inverse video and click once. If the result of the selection is another 
window menu, select the secondary selection in the same manner. Many of 
the desktop options require a filename to perform their process. There 
are two ways to supply the option with the filename, auto processing mode 
and prompts. The desktop windows options, printer icon and trash can icon 
will check whether a file or program module has been selected from the auto 
catalog on the desktop screen. If an auto processing catalog is present 
and a filename has been selected, the filename will be passed to the desktop 
window option or icon and be automatically processed. If no filename is 
selected for auto processing, you will be prompted for a device and filename. 
Example: DSK#. FILENAME . Using the prompt method allows for random access 
to any file in any valid device. Using the auto processing mode method 
allows for ease of use and speed in getting around the desktop options. 

AUTO PROCESS I NG MODE 

To initially activate the auto processing mode of the desktop, place the 
pointer on the word "System" of the desktop screen and press the fire 
button. When the system menu window appears, select "Work Disk" and click 
once. Another window menu will appear displaying disk drive numbers. 
Select the drive number you desire to be auto cataloged and click the 
fire button. All windows will disappear and the drive number selected 
will be placed to the upper right of the auto catalog section. 



A.l 



To catalog a disk and make its files available for the automatic 
processing mode, place the pointer on the disk icon and click the fire 
button once. The auto catalog module will load and run from the system 
disk and the first page of filenames from the selected disk will be 
displayed on the desktop screen in the auto catalog section. To view 
additional filenames, place the pointer on the pager icon (The box that 
looks like a bent page corner located below and to the left of the file 
names) and click the fire button once. With each click the next page of 
filenames will be displayed. The paging of the auto catalog is circular 
with the first page following the last. A file/program name may be 
selected for auto processing only from the page currently on the screen. 
Clicking on the pager icon or closing the auto catalog with the disk 
close button, will deactivate the previously selected file from being auto 
processed. To select a file for auto processing, place the pointer on the 
filename and press the fire button. The filename will appear in inverse 
video and will be available to the desktop options. To select another file 
for auto processing, the previous file must be turned off by the same 
manner then another file may be chosen. 

If you wish to auto catalog another disk, place the pointer on the disk 
close button and press the fire button once. This will clear the auto 
catalog on the desktop screen. To catalog the new disk place the pointer 
on the disk icon and click the fire button. If the new disk is in a disk 
drive other than the one that is displayed to the right of the auto 
catalog section, you must change the drive number from the "Work Disk" 
window menu then proceed to access the disk icon. 



DESKTOP W I NDOWS 



Work Disk 

Selecting this item will cause another window menu to appear on the 
screen. The disk drive chosen from this menu will be the disk opened to 
the auto driven mode when the disk icon is clicked. You will notice that 
the "1" to the upper right will now display the number of the drive 
selected (Drive one is the default drive) . This selection may be accessed 
only when no auto catalog is opened and displayed. Once a disk has been auto 
cataloged, the Close Disk button must be clicked, then access to this option 
will again be available. 



Pr i n-t &r 




Choosing this item will cause a system module to load and display another 
window with the current printer name. If the name must be changed , select 
the change name line and click. Type the new printer name and press ENTER. 
The name designated in this option is the device to which files will be 
printed. 



Col 

The selection of Color will cause the color change module to load and 
run from the system disk and display another window for selecting a change 
in either the foreground or backround color. Choose the desired option 
and click once. Now you may change the selected foreground/backround 
color by moving the joystick. When the color is on the screen click once 
and you may again make a selection. If no further changes are needed 
pull/push the joystick till no selection is in inverse video and click once 



I n fo 

Selecting Info will cause the file listing module to load f run and display 
an information file. As in viewing a file f you may page through the file 
by pushing the joystick forward or left and right to see other sections of 
the current page. The file used is "INFO" on the system disk. Feel free 
to edit this file with any text editor and add any information you wish. 
When you wish to quit viewing the file, click the fire button once. 



Blank Scrn 

This option will cause the monitor screen to blank out. To resume, press 
the fire button or "Q" on the keyboard and the desktop screen will again 
be visible. 



Memor y 

The memory option will load and run a system status module which will 
display the current system configuration. The information displayed i 
as follows: 
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1. High memory - The number of bytes left in high memory to load 
and run program modules (Ed/Assm option #3 & 5) written in c99. 

2. Low memory - The number of bytes left for "c99 H stack usage before 
an overlap into the Ed/Assm utilities would occur. This is also 
the same memory area left for loading program modules into low 
memory. If stack usage is minimal f program modules may load 

here without adverse affects. 

3. Stack pointer - The current decimal location of the c99 stack. 

4. REF/DEF pointer - The current decimal location of the bottom 
of the REF/DEF table. 

5. REF/DEF table - the number of bytes available to the REF/DEF 
table for additional labels before an overlap into the c99 stack. 
The number of available labels is this number divided by 8 bytes 
per entry. Upon exit of a user module its label space used is 
reclaimed and made available to the next user created program. 

6. No. windows defined - This is the number of windows already created 
and active in CSHELL99. These windows may be used in user created 
programs. Also includes user created windows. (See CSHELL99 Windows) 

7. Windows available - The number of user defined windows available 
for creation. (See cSHELL99 WINDOWS) 

8. No. window bytes used - This is the total number of bytes used in 
VDP RAM for currently defined windows. 

9. No. window bytes available - The number of bytes available for 
user defined windows. The number of bytes for a particular window 
is the number of characters in width times the number of lines that 
the window occupies. Example: A window 20 characters wide and 5 
lines in length would take 100 bytes of VDP RAM. This amount of 
memory available for window definition will vary depending on the 
number of files in the current auto catalog if one is open. 

(See VDP MEMORY MAP) 

10. Mutiple/Single Drive System - This message displays whether you 
have chosen to run as a multiple or single drive system. 
( See Single Dsk under the System desktop window ) 



Save 



Save will write the screen ^ CL olnr information an d the p r inter name toa 
system file as a permanent change to the program so the user need not 
configure the program with each rerun. Mat^ qnrfr jthat the s^ gtem disk 
with the file $CQNFI (SYSTEM DISK Side A) js inai drive whichcaiTE ^]ac c essed . 

I strongly suggest that you copy the system disk with your favor rte~copy 

program and work from the copy disk. 
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Install will allow the user to add c99 libraries to th e. cSHELL99 shell .as 
if it were part of the original program. The installed libraries and 
related labels may be accessed by programs loaded with the loaders with 
out having to load them in each time they are needed (as with Link & Run). 
Any normal c99 library may be installed without modification as long as 
there isn't a double definition error caused by an entry label. To check 
the memory available after the installation of a library, choose Memory 
from the System window and the updated information for relocatable modules 
will be displayed. If an error occurs during the installation of a module, 
an error window with the I/O error number will be displayed. Press the 
fire button or "Q" to remove the error window. 

Remove will delete all installed libraries and reset the memory pointers 
for the cSHELL99 environment to their original values. 

Sing leDs k: 

This option will toggle between a single or multiple disk system. Many 
of cSHELL99 f s desktop window options load an option module from the system 
disk which in turn accesses the file and disk selected for processing. By 
selecting to run as a single disk system, the desktop program modules after 
loading wilL p*"** ^ nd display a p ause window* I T necessary, swap disks at 
this time and press the fire button to continue. 



File 



Vi ew 

View will load and run the file listing module from the system disk and 
display the selected text file in a window. To page through a file push 
the joystick forward to advance to the next page. To view other sections 
of the current page (As in TI Writer or ED/ASSM Editor) move the joystick 
left or right. Below the viewing window is another window showing the 
line number of the last line in the viewing window and the starting column 
number of the page section being viewed. To quit viewing a file press the 
fire button once. 

Cop y 

Copy will load and run a file copying module from the system disk and prompt 

for two filenames, the original filename and the copy filename. 

Example: DSKi. ORIGINAL and DSK2.C0PY. (In auto mode the original filename 

is supplied automatically). To abort this task press ENTER without 

supplying a name. As of now the file copying module will only work with 

two drives unless you are copying a file to a different name on the same 

disk. 
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The file renaming module will load from the system disk and prompt for a 
disk #» old filename and new filename. Example: l v OLDNAME, NEWNAME. (In 
auto mode the disk drive number and old filename is supplied) It will then 
rename the file as requested and return to the desktop. To abort this 
process just press ENTER when prompted for a filename. 

Print & F"*- i nt Icon 

The text printing module will load from the system disk and prompt for a 
device and filename if no selection was made from the auto catalog. 
Examples DSK#.Fname . If the text file is found f a window will appear on 
the screen in menu mode and allow the user to set the lines that will be 
printed if desired. To set the printing ranger choose "Set parameters" from 
this window and you will be prompted for the line numbers to start and stop 
the printing. Enter the information and the lines between the start line 
and stop line (inclusive) or end of file will be printed. To print the 
entire file f press the fire button without selecting Set parameters. The 
default values are start line = one and the stop line = 10000 or end of file. 
Once the printing has started, it may be stopped by pressing the fire 
button. This selection may also be used to create a text file from any 
section of an existing text file by changing the printer name to a disk 
filename before accessing this module. If you do this* remember to reset 
the printer name when finished. 

S^&ly- cz ki 

The Search module will search a display variable/ fixed file for any key up 
to 80 characters. When a record containing the key is found, the record 
number and the entire record will be displayed on the screen. To pause the 
search press the space bar and to resume release it. DO NOT press FCNT/4 
or the program will abort. When the entire file has been searched, a 
message will be displayed. Press the fire button to exit the module and 
return to desktop. If a file has been selected for auto processing the 
filename will be supplied else at the prompt enter DSK#. FILENAME . 
NOTE: The search is case sensitive. 

w>€ "t £z> ZL "Z. •fcf' 

This module will display the number of lines and characters in D/V 80 
file. After the file data is displayed, press the fire button to exit. In 
auto mode the filename will be supplied else at the prompt enter 
DSK#. FILENAME. 

1 ^"fc & Trash Can Icon 

If in auto mode the filename will be supplied else enter DSK#. FILENAME 
of the file you wish to delete. You then will be asked if you are sure you 
want to delete the file. Press "Y" to delete the file or abort the request 
by pressing any other key. If a file is protected it will not be deleted 
and no error message will be issued. 
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Protect 



Choosing this option will load and run a file protection module. At the 
prompts enter the disk number and the filename you wish to protect. If 
in auto mode f the filename will be supplied and automatically processed. 
The file will be protected and the module will exit to CSHELL9S. If the 
file can not be found on the specified diskr a file I/O message will be 
shown. Click the fire button once to exit the module. 

Unpr ot ec t 

The unprotect option will remove the file protection from a file if it is 
protected otherwise no action will be taken. At the prompts enter the disk 
number and filename of the file you wish to unprotect. In auto mode the 
disk and filename will be provided for you. The file will be unprotected 
and exit to desktop. If the file can not be found on the specified device, 
a file I/O window will be placed on the screen. Click the fire button to 
remove the window and exit to desktop. 



A traditional disk catalog program written by Clint Pulley and disassembled 
by Tom Wible will load and display a window with disk drive numbers. 
Select the desired drive and a catalog of the selected disk will be shown. 
If no catalog is desired, press the fire button without making a selection 
and you will exit the module. When prompted to press a key, you may press 
any key on the left side of the keyboard or the fire button. The file 
symbols used are the same as in the auto catalog and are as follows: 



Rename 

The disk renaming module will load and run and prompt for a disk #. The 
selected disk will then have its name displayed and you will be asked for 
a new name. After the new name is entered, the selected disk will be 
renamed as requested and the module will exit. To abort this process 
enter zero for the disk number. DO NOT rename the System or Modules disks 
or the modules will not load properly as intended. The sytem disk is 
named *0 and the modules disk is ^MODULES. 

B-aic: kc op 

A disk sector copying module will load from the system disk and a reminder 
to insert the proper disk in the proper drives will be displayed. Also a 
chance to abort this task by entering "A" will be given. The user may 
also abort the task by entering zero for a disk number. If two valid 
disk numbers are entered, the sector copying proceedure will begin and 
exit to desktop when finished. 



DISK 



d 
D 
1 
I 
P 



Display variable (text) 

Display fixed (ED/ASSM option #3 programs) 
Internal variable 
Internal fixed 

Program Image (Basic programs, ED/ASSM option #5 
programs or binary data files) 
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NOTE: This module will only work with two disk drives and is not buffered. 
It simply reads a sector from the source disk and writes it to the copy 
disk. Both disk must already be formatted. REMEMBER, that sector copiers 
destroy the previous contents of the copy disk and produce an exact clone 
of the source disk. It will not unfracture the files from the source. 

Spec ± si 

Lose! & Run 

After selecting this option you will be prompted for a program module 
name. Enter the device and filename. Example: DSK1.M0DULE1 . To run, the 
module must be an ED/ASSM option #3 J ype program and have been set up to 
auto run (See instructions for creating an auto run module). Upon exiting 
the module you will return to desktop. To abort this task without running 
a program module, press the ENTER key without entering a filename. If the 
selected module produces an error during the loading process an error window 
will be displayed. Press the fire button to remove the error window. If 
the program was selected from the auto catalog it will load and run 
automatically. 

Link &c Run 

The Link and Run option will load multiple option #3 files^ as you would with 
the ED/ASSM option #3 loader. The name entered at the prompt is the name of 
a text file which contains a list of modules to be loaded. The last module 
to be loaded must be an auto run module. As explained in the ED/ASSM manual 
pg. 306, if an error occurs during the loading process the program will not 
run and the memory pointers will be reset. The most common errors would be 
duplicate definitions, a reference to a non-existing label and a lack of 
memory space to load a module. If this occurs, an error window will display 
the error number and upon pressing the fire button, the memory pointers will 
be reset as designated by cSHELL99. Remember, all functions and labels 
placed on the REF/DEF table are available to user created modules by using 
a REF or extern in your module. Familiarize yourself with the supplied list 
to avoid duplicate definition errors. 

NOTE: Both the Link & Run and Batch Run options load the linker utility from 
the system disk before the text list is accessed. If you have chosen to run 
as a single disk system, a pause window will be displayed after the linker 
has been loaded. Swap disks at this time and press the fire button to 
continue with the loading process. 

Batch Run 

The Batch Run option is similar to the Link & Run option with the exception 
that each module named in the text file list must be an auto run program 
module ( ED/ASSM option »3) . Each module in the text list will be loaded and 
executed. Upon completion of each module the memory pointers will be reset 
and the next program module will load and run (Up to 15 modules total). Upon 
exiting the last program module in the list, the user will return to the 
desktop. As with Link & Run, if the text file was selected from the auto 
catalog, the batch processing will execute automatically. 
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Pr og r" am LcJ r~ 



The Program Ldr option uses a modified version of Todd Kaplan's CHAIN function 
to load and run ED/ ASSM opt i on #5 (program image) files. Many program image 
files not created for csritLLyy will load and run using this loader but will 
not return to the shell unless they were created from within cSHELL99 
using the $SAVE utility (See Creating Program Image Files). If the program 
was selected from the auto catalog it will load and run immediately. If not f 
enter the device and filename of the program when prompted. Example: DSK1.NAME . 
If an error should occur during the loading process an error window will 
display the error number. Press the fire button or "Q H to remove the window. 
NOTE: This loader checks for a possible overwrite of the window data in VDP 
memory and if needed f will attempt to restore this area from a temporary 
buffer in low memory. Before the program module executes f the screen data 
and character definitions table for characters 0-239 will be stored in VDP 
memory starting at >1000. Upon return from the user program, the desktop 
screen and character definitions will be swapped back into their normal 
addresses allowing the user module to change characters in text or graphics 
mode without having to save the existing values. (See VDP Memory Map) 

EEcJ ± -fc or" 

As of now this option will load TK WRITER from the system disk. You must copy 
EDITA1/2 and CHAR A 1 of TK WRITER and $MEDIT from the ^MODULES disk (TKW files 
not supplied). If you create your own editor and wish this option to load it f 
the program must be an option #3 program set to auto run and must be named 
$MEDIT on the cSHELL.99 system disk. 

<z33 Compiler 

Copy files C99C, C99D and C99E to the cSHELL99 system disk (Files not 
supplied). The c99 V4.0 compiler will exit to the TI title screen. I hope 
to find a method to return or at least chain the compiler to the system. 

Exit c SHELL99 

Selecting this option will terminate cSHELL99 and reset the computer to the 
TI title screen. 

Loader Notes: 

All the loaders contained in the desktop "Special" window (Load & Run f Link 
& Run f Batch Run and Program Ldr.) will save the desktop screen and 
character definitions table for characters 0-239 into a temporary buffer in 
VDP memory starting at address >1000 to >1B40 (see VDP Memory Map). Upon 
return from the user created program The desktop screen and character 
definitions will automatically be rewritten from this buffer thus allowing 
a user to redefine characters and change the screen in both text and 
graphics mode without having to save the data to memory or a disk file. 
AlsOf all necessary system globals needed for desktop operation and current 
memory configuration are saved before and restored after each loader 
selection. The user created program must not alter this area. If you have 
need of this area of VDP memory save it to a disk file and restore it using 
binfilO before exiting your module (see cSHELL99 System Functions). 
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You may create a program image module ( ED/ASSM option #5 ) that will 
load and execute in low memory (Almost all of the desktop modules are 
located in low memory). If you do f the module must not exceed 4096 bytes 
in size or some of the window data in VDP memory may be overwritten. Also 
usage of the c99 stack should be minimal to avoid an overlap between your 
module and the c99 stack (See Low Memory Usage). A program image module 
that resides in high memory may use the entire available memory and will not 
destroy any window data because the Program Ldr. loader will restore any 
overwritten data from a buffer in low memory. 

Auto run modules (ED/ASSM option #3) may also load into low memory and have 
no effect on the window data. Again f use the c99 stack with caution to 
avoid any overlapping of program and stack. 
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MODULE AUTO RUNNING 



The c99 compiler converts "C" source code files into 
assembly language source files which are assembled with the 
assembler thus creating Ed/Assm option #3 programs. To 
enable a module to auto run when it is loaded is a very 
simple process. All that is needed is to have the starting 
function's name be placed on the REF/DEF table by the use of 
the entry statement and also place it after an END assembler 
statement. The following example will demonstrate this 
procedure. 



/* An example of an auto run program module */ 
entry autoi; /* Place autoi on the REF/DEF table #/ 

autoiO /# This is the starting function of the module */ 

{ 

int x; 
x=0; 

putchar (12); /% Clear the screen */ 
while<x<10K 

putsC'This is a test .....\n"); 

x++; 

> 

func2Q; /* Execute func2 */ 

> /* Exits module and returns to calling function */ 
/* DO NOT use exitO or abort O */ 

func2() /* Just another function in the module #/ 

putsCThis is another function")} 

#asm 

END AUTOI Auto run feature. Note the capital letters, 
iendasm 



In the above example y when this program module is loaded it 
will start executing autoi () and return to the calling 
function upon completion of autoi O. The assembler END 
statement with the starting name is the last statement in 
the source file . When compiled^ the object file (assembly 
source) will contain two END statements with the above one 
first followed by one supplied by the compiler. The 
assembly process will stop at the first one without causing 
any errors. 
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When creating auto run program modules to be used with cSHELL99 the function 
mainO can not be used as a function name because it is already defined as 
the start of cSHELL99. Also any labels placed on the REF/DEF table as a part 
of cSHELL99 f CSUP f CFIO or ED/AS5M utilities can not be used as a starting 
function name. Function names that are not made external <func2<) above ) 
may be called anything except mainO without producing a duplicate definition 
error. 



module: auto running/another method 



Here is another method of running a module without altering the module 
itself. This method can be used when using the LINK & RUN option or any 
linker that loads option #3 modules together from a text supplied list. 
Using the above example again f all the code would remain the same except 
the #asm, END AUTOI, #endasm would not be included. Instead f create a 
function module to branch to the starting function and make this 
function module auto run. 



/* Indirect auto running #/ 

entry bootit; /* Place boot it on REF/DEF table */ 

extern autoi O; /* Access autoi from REF/DEF table #/ 



boot it O 

{ 

autoi O; 

> 

#asm 

END BOOTH Auto runs boot it which runs autoi 

tendasm 



This method can be used to auto start a c99 mainO module by replacing 
autoi <) with start (). REMEMBER, The auto running module must be the last 
module to be loaded. DO NOT attempt to start a mainO function from 
the cSHELL.99 environment. This method may be used with text list linkers 
such as CL0ADV3A. 
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L I IMK I IMG LOADER 



The Linking Loader which is included in the utility programs in the Editor/ 
Assembler can load both compressed and uncompressed tagged object code 
programs < Ed/Assm option #3 files ). As explained on page 305 of the 
Ed/AssKi wianualf the loader attempts to load relocatable programs in high 
memory < >A000 - >FFD7 ) first. If there is insufficient space there, it 
will try to load programs between the utilities and the REF/DEF table in low 
memory i about >2676 - >3F37 ). This type of loader lends itself to creating 
very powerful programs if used correctly and to my knowledge does not exist 
in any other micro in the TI's price range. It allows separately created 
program modules to be linked together and run as one program, sharing the 
individual module routines and data if desired. The linking loader can also 
be used within a running program to load and execute program modules if the 
proper procedure is adhered to. Besides the data on the REF/DEF table, the 
loader uses these four memory locations in the loading process. 

>2024 First free memory address in high memory 

>2026 Last free memory address in high memory 

>2028 First free memory address in low memory 

>202A Last free memory address in low memory 

When cSHELL99 begins to run it copies the values of the above memory 
addresses to four integer variables. This saves the pointers to the memory 
area and REF/DEF table used by cSHELL99. To load an Ed/Assm option #3 program 
file, cSHELL99 uses the function loaditO which takes a device and filename 
string which is passed to it, creates a PAB, and executes the assembly 
language instruction LOADER. The program module is loaded and executed if set 
up to auto run < see Module Auto Run ) and upon exiting the module will return 
to the calling function. Upon return to cSHELL99 the four memory addresses 
above are reset from the four integer variables that were saved at the startup 
of CSHELL99. In effect, what this process is doing is to create an overlay 
area of memory both with the memory available for the module to be loaded and 
the REF/DEF table information put on as a module loads. By resetting these 
locations, the loader isn't aware that a program module has been loaded and 
executed and will re-use the same memory over and over again. If these four 
addresses were not reset, the memory available for modules would be decreased 
with the loading of each module and double definition errors would occur with 
the REF/DEF table if a DEF/entry of a same label name from a previously loaded 
module were to be loaded again. This process of loading and running other 
program modules from within a running program may be nested up to a reasonable 
degree. If you wish to use a module that was loaded and run by cSHELL99 as a 
shell to run other modules repeat the saving and resetting of the memory 
pointers described above and use loadit (filename) to load and run the module. 
In the following example the necessary steps are illustrated. 
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/* Example of a shell program within the CSHELL99 shell %/ 



extern loaditO; 

extern savptr O f rtnptr O; 

entry shell2; 



/* Load it must be referenced to be used #/ 

/% Memory management functions XI 

/% Starting function of this program */ 



shell2() 

{ 

savptr <) j 

1 oad i t < " DSK# . MODULE 1 " ) ; 
rtnptr C) ; 

1 oad i t < " DSK# . M0DULE2 " ) ; 
rtnptrO; 

1 oad i t < " DSK# . MODULE 1"); 
rtnptr <) ; 



/% Starting function %/ 

/% Save the memory configuration of this module %/ 

/% Loads and runs modulel from dsk# %/ 

it Loading changes memory pointers */ 

/* Resets memory pointers */ 

/* Loads and runs module2 from dsk# %t 

1% Resets memory pointers #/ 

/* modulel again */ 

/* Not needed if last module before return */ 
/* to desktop. Pointers reset by CSHELL99 %/ 



#asm 

END SHELL2 
#endasm 



/* returns to calling function (cSHELL99-desktop) */ 
/* DO NOT use exitO or abort <) to return to desktop */ 
Auto run feature 



In addition to loading and running ED/ASSM option #3 relocatable modules, 
the loader will load and run option #3 modules that start at an absolute 
address. In this case, the memory pointers will not be updated except for 
the last free address in low memory, which points to the bottom of the 
REF/DEF table. This enables any entry label to placed on the REF/DEF table 
in the usual manner. 
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CREATING PROGRAM I MAGE FILES 



It is possible to create binary program files (ED/ASSM option #5) from 
Load & Run modules (ED/ASSM option #3 ) by using the $SAVE utility on the 
system disk. $Save is a relocatable utility that performs the same 
processing as the TI ED/ASSM "SAVE" utility but from within the cSHELL99 
environment- To create the program image file f install the prepared file/s 
(see examples 1 & 2 following) then install $SAVE from the system disk. 
$Save will write part of the VDP window environment to the system disk to 
allow for larger programs then place a window on the screen prompting for 
a device and file name. Example DSK#.NAME . If you are using a single disk 
system F swap disks at this time. Upon pressing ENTER the file/s will be saved 
in a binary format which can be loaded with the Program Loader under the 
"Special" window. If you make a mistake or wish to save the module again f 
follow the prompts given you. If an error is produced in installing a module f 
an error window will be displayed showing the I/O error. If any error is 
producedr re-install the last library or choose "Remove" under the "System" 
window to remove all installed libraries and repeat the process. When $Save 
has been completed it will automatically remove all installed libraries and 
return to CSHELL99. 

To save a module/s as a program image file f $Save requires that three labels 
be placed on the REF/DEF table by the installed module/s. (SLOAD f SFIRST, and 
SLAST see examples.) You may save either a single module as in example #1 or 
nodules and libraries as in example #2. 

NOTE: No module installed for this purpose should be set to auto run. Also 

before returning to cSHELL99, the system global "modnum" should be set to 
zero and all installed libraries should be removed (see examples). 

Example #1 Single Module 



extern jwait () , putbox() f clbox() f endboxO , bxtext () f modnum y single f How; 

/* The extern allows access to the above labels on the REF/DEF table */ 

entry sload,sf irst f slast ; /# place labels on REF/DEF table */ 

#define query 7 /% equates the word query with window #7 #/ 

/* Place the following after any extern f entry or #define but before any 
function or memory allocation command %/ 

#asm 
SLOAD 

SFIRST LWPI >8300 Load c99 workspace. Note capitals.. 

B 3M1SG Branch to start of module. 

#endasm • 
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msgw /* starting function */ 

i 

put box query, Iv, lv;; /* place window #7 at row Iv, col 10 */ 

bxtext <.query,2, 1, "This is a message" , Lj; /* place message in window & */ 

jwaitO; /* wait for button press or "Q" */ 

cl box*; query, 0,0); /* clear out window 7 */ 

endbox (query) ; /* remove window 7 from screen */ 

/* the following code removes installed libraries and sets modnum to 0 */ 

modnum=0; /* set modnum to zero £/ 

/* removing installed libraries by resetting values in a memory 

function which will execute upon return to cSHELL99 */ 
#asm 

LI 0,LL0W 
INCT 0 
LI 1, SINGLE 
AI 1,4 
LI 2,4 
LP1 MOV *0+ f *l+ 
DEC 2 
JNE LPi 
#endasm 

> /* End of program. Return to cSHELL99 */ 

#asm 

SLAST END last memory location in module 

#endasm 



Vou would compile and assemble the above example then install the option #3 
module produced. After installing the module, install *SAVE and follow the 
prompts. If you wish to abort this process, press ENTER without supplying a 
device and filename. 



Example #^ Multiple Modules 

This example will require SLAST to be placed in a module different than the 
module containing SLOAD and SFIRST to allow for other libraries to be included 
in the saving process. The module *LAST on the system disk may be used to 
supply the SLAST label. 



extern printfO, modnum, How, single; /* access labels from REF/DEF table */ 
entry sload,sf irst ; /* place sload & sfirst on REF/DEF table */ 

#asm 
SLOAD 

SFIRST LWPI >8300 load c99 workspace 

6 ASTART2 branch to starting function 

#endasm 

char strgC33]=<"This is a message on the screen"}; 
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start2Q 
{ 

put char (12) ; 
locatedO, 1); 
printf <"y.s%strg); 
getchar O ; 



/* starting function */ 

/# clear screen */ 
/* position cursor */ 
/* print message */ 
/# wait for keypress */ 



/* the following code removes installed libraries and sets modnum to 0 */ 

modnum=0; /* set modnum to zero */ 

/* removing installed libraries by resetting values in a memory 

function which will execute upon return to cSHELL99 */ 
#asm 

LI 0,LLOW 
INCT 0 
LI 1, SINGLE 
AI 1,4 
LI 2,4 
LP1 MOV *0+,*l+ 
DEC 2 
JNE LP1 
#endasm 



/* End of program. Return to cSHELL99 */ 



The above example would be compiled and assembled with the resultant option 
# 3 module being installed first. All needed libraries not contained in 
cSHELL99 would then be installed. After the libraries are installed 
(print f in this example), install the module $LAST from the system disk. 
Finally, install $SAVE from the system disk and follow the prompts. On return 
from $SAVE, all installed modules will be removed automatically. 

If you use the name "start 2" as the starting function of your program module 
as above, you may use the module $FIRST on the system disk to supply the 
SLOAD and SFIRST labels. In this case, eliminate the following in the above 
example. 

entry sload,sf irst ; 

#asm 

SLOAD 

SFIRST LWPI >8300 

B 0START2 

#endasm 

And add an entry for start2. Example: entry start2; 

This time install *FIRST as the first module followed by the program module, 
needed libraries, *LAST and *SAVE. 
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c SHELL99 SYSTEM FUNCT I ONS 



The following is a description of cSHELL99 functions and globals that may be 
used in user created modules. To access the functions and globals an extern 
statement must be contained in the user created module. 

upper <strg) ; Upper will replace all lower case characters in the 
string "strg" to upper case. All non-lower case characters will remain 
unchanged. 

jwait C > ; Jwait is a pause that will end with the pressing of the fire 
button on the joystick or "Q" on the keyboard. 

s-fc r- <gc p»y <I s~b rgl , s"b v > ; Strgcpy will copy strg2 into strgi. 

>c=j oys*t '21 C > ? The josytZ'O function will read and return the 
position of joystick #1 as a number from 1 thru 18 (description below). It 
also detects the arrow keys and "Q" on the keyboard and returns their value 
as a corresponding position of the joystick. 
Example: 

Down arrow =4 

Left arrow = 8 

Right arrow = 12 

Up arrow = 16 

hqh = s 

In addition, joyst2Q will detect a press to key #5 and load and run a 

specified relocatable screen dump program module created to auto run 
( see SCREEN DUMP UTILITY ). 



Joystick Return Ua lues 



NA 

2 4 6 8 10 12 14 


16 


18 =f 


g !• *a *- -* K - 


t 




1 3 5 7 9 11 13 

BO 


15 


17 


x = Uithout Button Pres 


sed 




& = Uith Fire Button Pressed 




Hh = No Action 






BO = Button Only 
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mouse Mouse, a system global r contains the return value of the 

last call to the joyst2Q function and may be a value 1 - 18 ( for meaning see 

joyst2Q ). 

n=mmov^5 The mmove function calls joyst2Q to move the pointer 
around the screen within the boundaries set by the system globals ctop f cbot F 
cleft* and cright. When the fire button or "Q" is pressed^ the VDP screen 
address (0-959/0-767) of the present pointer position is returned. The 
position of the pointer may also be found in crow (row 1-24) and ccol 
(column 1 - 40/32). Before calling mmoveO the first time f set crow and ccol to 
the screen position you wish the pointer to appear in and execute getvdpO and 
putvdp(l) to save the screen character under the pointer and place the pointer 
on the screen. 

Acceptable Values 

Upper line boundary for pointer. 
Lower line boundary for pointer, 
left column boundary for pointer, 
right column boundary for pointer. 

NOTE: Because mmove () calls joyst2() f the screen dump module is made 
available by pressing key #5 on the keyboard ( see SCREEN DUMP MODULE ). To 
disable the loading of this module in your program module^ set the system 
global "mkeys" to one and upon exiting your program set mkeys to zero. 

putvclp (asc > ; Putvdp will place the character passed (asc) on the 
screen at the location contained in the system globals crow and ccol. 
Example: putvdp(l) will place the pointer on the screen. 

cj^-fc vdp <C > 5 This function gets the ascii of the character at the 
screen location determined by crow and ccol and places the value in the 
system global "schar". 

loadi t (strg) 5 Loadit creates a PAB for the filename passed 
(strg) and branches to TI's relocatable program loader (LOADER) which loads 
and links ED/ASSM option #3 program files (normal c99 language program 
modules). The string passed is the device and filename of the module to be 
loaded and may be in either upper or lower case. Example : DSK1.M0DNAME . If 
the module was created to auto run* upon exiting the program module the return 
will be to the calling function in cSHELL99 (see MODULE AUTO RUNNING). 
Loadit is used in cSHELL99 by the Load and Run f Link and Run f Batch Run and 
Install options of the desktop. Read the documentation for each option to 
become familiar with the different uses of loadit (). If a module is not 
successfully loaded f loadit will display an I/O error window with the error 
number displayed. Upon pressing "Q" or the fire button you will return to 
desktop. 



ctop 1 - 24 

cbot 1 - 24 

cleft 1 - 40/32 

cright 1 - 40/32 



E.2 



to ± n f ± 1 < op 9 f name 9 vdpadd r byt es > 5 Biniil creates 
a PAB for filename (fname) and loads/saves the vdp buffer area (vdpadd) 
to/ from the filename for (bytes) number of bytes. 



op = 1 Read a file into vdp buffer, 
op = 0 Save the vdp buffer to a file. 

fname = Filename of file for save/read (ex. DSK#.NAME ). 
vdpadd = Decimal starting address of VDP buffer, 
bytes = Number of bytes to save/read. 



Binfil is a very powerful and versatile function and can be used for a 
multitude of purposes such as loading/saving screens* character definitions! 
data f program segment s f etc.. 

Example: binf il (0, "DSKl. SCREEN" ,0, 960) ; will save a text mode screen to the 
file "SCREEN" on disk drive #1. To reload the same screen, change the op code 
to "1". ( binfil (1, "DSKl. SCREEN", 0,960); . If an error occurs, a window 
will be displayed on the screen showing the error number. Press "Q" or 
fire button to remove the error window. 

aatoi (x, strg) ? Aatoi is atoiO renamed to allow for the 
usage of the printfO function. It takes a string (strg) consisting of 
numbers and sets the integer (x) to the value represented by the string. 
Example: If strg=" 12345", then x would equal the number 12345. 

± ± -b ocJ Cxcf s*fcirc|F n byt > ; Iitod is itodO renamed to 
allow for the usage of the printfO function. It creates a string (strg) 
representing the value of the integer (x) nbytes in size. The number of bytes 
must include a byte for the null string terminator and a byte for the sign of 
the number. 
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c SHELLS9 W I NDOW FUNCT I ONS 



The following window functions are a customized subset of a previous 

library created by myself and latter enhanced greatly by Tom Wible 

of Sterling, Va.. There are many changes in the windowing system such as 

an increase in the amount of VDP memory available for window data and 

the method of swapping the screen area with a window. Also because of 

the increase in memory available for windows the number of window that 

can be created is increased from 20 to 30. Though some of the previous 

function call will work with this version, it is recommended that you 

check window using modules with the following syntax to ensure compatibility. 

The following functions are contained in cSHELL99 and are available to user 

programs by using externs in their modules except for makboxO and getboxO 

which are in SADDBOX ( a separate library which may be installed ). Some of 

the functions that were in the previous version will be included as add on 

libraries that can be loaded. All window functions will now work in text and 

graphics mode in the same manner. 

n =m<3t Kct3o>c (width, 1 i n <e*s y st r g > ; 

This function will create dialog boxes < windows ) in VDP memory and set the 
appropriate pointers in the array boxdta. To create a window the function 
must receive the following informations The width of the box in characters, 
the length of the box in lines and a string containing the actual characters 
that the window will be comprised of. If you wish the window to be in inverse 
video, the string containing the window data must be converted using the 
ivideo(strg) function before calling the makboxO function. Every time this 
function is executed, it will automatically create the next window number. 
The first execution is window #1, second is window #2, etc... The window data 
is stored in VDP memory starting at location 8192 < see VDP MEMORY MAP ) and 
allows for a minimum of 4034 bytes of window data to a maximum of 5558 bytes 
depending whether an auto processing catalog is active. < see VDP MEMORY MAP ). 
The array boxdta, which contains all pointers to the window and screen data 
will allow for the creation of up to 30 windows. The amount of bytes a window 
will occupy can be found by multiplying the width times the length. The 
function returns the number of the window created or 0 if the window was not 
created because of a total box data exceeding 5558 bytes or 30 windows being 
already defined and active. 
Example: n=makbox(20,5,string); 

Makes a window 20 characters wide and 5 lines long from the 

specified string. i 100 bytes) 

n=g«^-b fc>o>c (fil «=*nc=*m^ > ; 

This function, created by Tom Wible of Sterling, VA. , will read the D/V 80 
file specified and create a window from the lines in the file. It returns 
the window number if successful, null if not. The file is a text file 
which contains the window data as you wish it to appear. The width of the 
window is set by the first line in the file and will be the number of lines 
in the file in length. Do not include extra blank lines on the end of the 
file. Also, the text must start at column #1. 
Example: n=getbox<dski. windowa) ; 
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J^C .^L -*^C J^C J^L J^C J^L J^C .^L 

* This is a sample box * — DSKi.WINDQWA 

* in a text file. * 

1 ■ - i - -A- -X - A- -A- A - ■ A • ■ A ■ -A* A- A- A- A- A- - A A- -A- J - A- A- -A- - ■ * -A . -A. 
•j^ *T* * »^ ^V* ^Y* * ^Y* ^Y* 

NOTE: If you wish to have the border of the window as a hi-res border 
such as in cSHELL99, run the module Border with the file before 
calling this function. i see Companion Modules ) 



n =c lbox Cbox y s*b ^ir *b 9 s"b op> > 5 

This function will turn all characters from window line start 
to line stop to blanks. ClboxO is used to blank out any part of 
the window that has been used to display a message allowing the same 
window to be used repeatedly for different messages or inputs. It 
must be called before endboxO for windows used for these purposes or 
the message in the window will become part of the window upon calling 
endboxO . The function returns a one if successful or a zero if not. 
Windows that only display the data that they were created with should 
not be used with this function. 
Example: clbox<3,4,7); 

This example will clear line 4, 5 F 6 and 7 in window #3. 

To clear the entire window, except for the border, use zero for the start 
and stop parameters. 
Example: clbox (3 f 0,0) ; 

This example will clear all of window #3 except for the borders. 
n=put box C L* o >£ 41= * 1 i ne , czol > 5 

If the specified window is not already on the screen, putboxO will 
place the window on the screen with its upper left corner at the screen 
line and column. The entire window must be able to be contained within 
the 40/32 columns or a distorted window will be the result. If the window 
is already on the screen nothing will happen and a null will be returned 
else a one will be returned. 
Example: n=putbox (query, 10, 10) 5 

This example will place the window "query" on the screen at screen row 10 
and screen column 10. 

n=endbox Cbox#) 5 

This function will pop a window off the screen revealing what was underneath 
it. If the window was not on the screen, nothing will happen and a null 
will be returned. If successful, a one will be returned. Because the 
windows directly swap data with the screen below it, the function clboxO 
should be used on those windows used for varying messages or inputs before 
calling endboxO. 
Example: n=endbox(3) ; 

This example will pop window #3 off if it was on the screen. 
NOTE: If there are multiple windows on the screen and they overlap, it is 
the programmer's responsibility to pop the windows off in reverse order. 
The top window must be popped off first then the window below it etc... 
If the windows do not overlap, they may be popped off in any order. 
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n=menu C wi ndow#) ; 

This function will enable any window to be used as a menu. By using 
joystick #1 or the arrow keys on the keyboard a user may move to any line 
within the window causing the current line to be in inverse video. When 
the fire button or "Q" key is pressed* the function will return the window 
line number of the current line at the time of selection. The line number 
will always start at 2 ( to allow for the border ) and increase by one to 
n C bottom line of the window ). To move down one line f pull the joystick 
back or press the down arrow (X). To move up one line f push the joystick 
forward or press the up arrow (E). To make a selection and return to the 
calling function? press the fire button or "Q" on the keyboard. If the 
window is not on the screen a zero will be returned else the window line 
number will be returned. 
Example: n=menu(10) ; 

If on the screen f window #10 will become a menu. 

NOTE: When using a window as a menu the window should be on top with no 
portion under another window. Also this function calls the function 
joyst2Q to access the joystick and arrow keys. As a result the screen 
dump module that loads when key 5 is pressed is available. If you do not 
wish to have this module available, set the system global mkeys to a one. 
Upon exiting your module, reset mkeys to zero. If you do allow for the 
loading of this utility in your program you must set the memory pointers 
in your program by using the savptrO function to set the shell to include 
your program as described in LINKING LOADER/a shell program within a shell 
program and the global mkeys should not be accessed. SavptrO will only 
work properly with relocatable modules. In absolute address modules the 
global FHI should be set to an address just beyond the end of your program 
if it is in high memory then call savptrO. 

x v± cJ&o Cst r g > ; 

This function will take a string of standard/inverse characters and toggle 
the characters between their normal /inverse video equivalent. Once a string 
has been converted to its inverse video equivalent, the normal string 
displaying commands such as putsO will not display it properly. However, 
the graphic function hcharO and wrtlinO from this library may be used to 
display the inverse video text. If the inverse video text is to be displayed 
in a window, the function bxtextO can be used. When a string of inverse 
characters are toggled back to their normal equivalent, it may again be 
displayed with normal c99 functions. 

n =fc> &>a±^ Cbox#, wr ow r wc ol r s*t r g , op cz ode J> ; 

This function will put/get a string inside a window at window row and 
window column. The parameters passed are window number, window row, window 
column, a string with data or to accept data, and an operation code ( 0 gets 
a string and 1 displays a string ). Wrow #1, Wcol #1 will start one line 
down from the top of the window and one column in from the left to allow for 
a border. If the specified window is not on the screen, a null will be 
returned. If the operation is to receive a string, the number of characters 
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received will be returned. The string input process will terminate with the 
enter key being pressed or the right border being reached. If the operation 
is to put a string in a window? The number of characters displayed is 
returned. Any string that is too long to fit in a window will be truncated 
at the right border of the window. Example: n=bxtext (14, 2? 1? message? l)j 
In this example* if window #14 is on the screen? the string "message" will 
be displayed at window row #2 and window col #1. 

n=sn g ^"b s C r~ ow r c: ol * m&.XL r s-fc i- cj > ? 

( Text mode only unless you compute the graphics row & col ) 
This function will input a string at screen row and screen column for a 
maximum of max number of bytes. The input process terminates with ENTER or 
upon reaching max number of bytes. The function also allows for back 
spacing i fctn/S ). Returned is the number of characters entered (len). 
SngetsO is not a window oriented function but is included because it is 
called by bxtextO when input ing a string. It also is a very useful function 
when called directly. 

ir cJ 1 ± n <: vcJpj^icicJir * st v cj > 5 

RdlinO is a function used by many of the window functions and is made 
available because it can be of great use being called directly. It reads a 
line of characters into a string strg directly from the screen starting at 
vdpaddr for "parrr^" number of bytes and adds a null at the end. Before 
calling this function the system global parm2 must be set to the number of 
bytes you wish to read and the VDP address vdpaddr must be computed. To 
compute the VDP address of a screen row and column? the following algorithm 
can be used. 

vdpaddr =<<row-i>*40>+(col-l>; Text mode 
vdpaddr=( Crow-1 )£32>+<col-l > ; Graphics mode 

wir t 1 in C vdpaddr 9 sHb *- g > ; 

WrtlinO like rdlinO also can be of use when called directly. It writes a 
line of characters to the screen starting at vdpaddr from the string strg for 
"parm2" number of bytes. As in rdlinO? parm2 must be set to the number of 
characters you wish displayed and the VDP screen address must be computed. 
WrtlinO is useful in displaying strings containing inverse video characters 
and/or other non-di splay able characters. 

NOTE: WrtlinO does not use a null to determine the end of the string hence 
the used of parm2. As with all window functions? parm2 must have an extern 
in your program module to be accessed. 
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WINDOW GLOBALS 



Boxdfca is a global integer array consisting of 120 elements ( 0-119 ) 
in which 30 sets of 4 consecutive elements contain the following 
information for each dialog box: 



Box Element Usage 

1 This element contains the VDP storage position for the 

characters that make up the window and is loaded by the 
makboxO function. Once loaded, it remains constant and 
may be accessed by the algorithm: 

n=boxdtaC (boxnumber-1 )&41 
This is also the position that screen characters which 
would be under a given window will be swapped to when the 
window is put on the screen by put box O. 



2 This element contains the width of the window in characters 

and is loaded by the makboxO function. Once loaded it 
remains constant and may be accessed by the algorithm: 

n=boxdt at ( (boxnumber-1 ) *4) +1 1 

3 This element contains the length of the window in lines and 

is loaded by the makboxO function. Once loaded it remains 
constant and may be accessed by the algorithm: 

n=boxd t a E C (boxnumb er - 1 ) *4 ) +2 ] 

4 This element contains the starting screen position of the 

window ( VDP address ) and is loaded by the put box O 
funtion. It is updated every time put box O is used to put 

a particular window on the screen. When a window is removed 
from the screen? this element retains the last position of 
the window. It may be accessed by the algorithm: 

n=boxdta£ < (boxnumber-1 )£4)+33 
This is also the position that the screen characters will be 
rewritten to when the window is popped of the screen by the 
endboxO function. 

NOTE: In the "C" language all arrays start with the subscript "0". 

Thus the information for window #1 is in elements 0 - 3, window 
#2 is in 4 -7 



In addition to the boxdtaCD array there are five more significant global? 
used in conjunction with the window functions. 
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parm2 



This global is used primarily with the rdlinO and wrtlinO 
functions which are accessed from numerous windowing 
functions. It is set to the width of a specific window and 
is used in the matrix weaving routines- Since rdlinO and 
wrtlinO may be used directly, parm2 must be set to the 
desired width before these functions are called. 



boxpos 



Initialized to 8192, this global points to the VDP storage 
area for the next window to be created by the makboxO 
function. 



boxptr 



This global is initialized to 0 and is used by the makboxO 
function to load the proper elements of the boxdta array. 
It points to the element #1 entry for the next window to be 
created. 



boxnum 



Boxnum contains the window number of the last window created 
by the makboxO function ( windows created 1-30 >. If seven 
windows were created then boxnum would contain the number 7. 



onscrn 



This global character array contains 30 elements initialized 
to zero and is accessed by most of the window functions to 
check whether a particular window is on the screen. If a 
window is displayed on the screen, its corresponding element 
Cboxnumber-13 will be set to a one otherwise it will contain 
a zero. Checking onscrn is very useful when creating 
additional window functions. 
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cSHELLSS COMPANION MODULES 



The following is a list of program modules and c 99 libraries on the MODULES 
disk side A that have been set up for the cSHELL99 environment. Following 
the module name will be the suggested loader to use and a description of the 
program. 



1. EARTHBAT (Link & Run) 

Earthbat is a text file to be used by the Link & Run option under the 
"Special" desktop window. The GRAPHICS , SPRITES libraries and the auto 
run program EARTH will be loaded and run a graphics mode demo with 
multiple sprites and rotating planets. To return to cSHELL99? press the 
fire button or "Q" key. 

2. SDEMOBAX (Link & Run) fV' y/ 



Sdemobat is a text file submitted to the Link & Run loaded. The SOUND? 
GRAPHICS and SPRITES libraries and auto run program SDEMO will load and 
execute a demonstration of the above libraries and return to cSHELL99. 

3. $REFLOOK (Load Sc Run) 

$Reflook is an auto run utility module which displays the current labels 
on the REF/DEF table, the hex address that corresponds to the label and 
address of the entry in the REF/DEF table. Press "Q" or the fire button 
to page through the table. If key #5 is pressed? the screen dump utility 
will load allowing you to print the current screen. After the last 
screen is displayed? you will return to cSHELL99. 

4. SLIDE (Load & Run) 

Slide is an auto run program that places the "System" window on the 
screen and slides it from left to right then enters menu mode. Press 
the fire button or "Q" to slide the window back to the left where it 
will again enter menu mode. Press the fire button twice to exit menu 
mode and return to cSHELL99. 

5. BATCHTEST (Batch k Run) 

NOTE: Install the GRAPHICS? SOUNDS and SPRITES libraries before 
submitting this batch list to the Batch h. Run loader. 

Batchtest is a text list of auto run program modules. Each module in 
the list will load and execute in turn. Upon exiting a module? the next 
module in the list will load and run. After exiting from the last 
module? you will again be in the desktop. 
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6. *ADDBOX (Install) or (As a file in a Link & Run list) 

$Addbox is a library which contains two window functions, get box O and 
roakboxO, which enable a user to add windows to cSHELL99. See cSHELLSS 
WINDOW FUNCTIONS for further description. 

7. fADDTEST (Load & Run) 

NOTE: Before running this module? install *ADDBQX. 

$Addtest is an auto run module that uses getboxO to create two windows 
from the files WIND1 and WIND2 and displays the WIND1 window on the 
screen. Press the fire button and the WIND2 window will be placed on 
the screen. Press the fire button to exit the module. 

8. ^BORDER and *BORDER2 (Load & Run) 

$Border/2 are two auto run programs that take a text file set up for 
creation of a window and replaces the text border with a hi-res border. 
The text file must start on line one, all the way to the left and 
contain no extra blank lines. The processed file is saved back to the 
original filename. 
Example: 

################### In this example the #'s would be replaced by a 

# This is a test # hi-res border. ^Border produces a single pixel 

# window... # line border and $Border2 produces the same borders 
################### as the cSHELL99 windows. 

There is a text file on the MODULES disk named WINDOW. As a test, view 
WINDOW with the View option of the File window, then run ^Border or 
*Border2 using DSK#. WINDOW as the input file. Again view WINDOW and 
you will see the resultant change in the border. The text file may now 
be used with getboxO to create a window with a hi-res border. 

9. *CALEN (Load & Run) 

$Calen is an auto run program module that will display a calendar for 
any month from 1/84 to 12/99. After the calendar is displayed, you will 
be given a choice to select another month. If Key #5 is pressed at this 
time, the screen dump utility will load allowing you to print the 
current calendar. If you do not select to repeat the calendar process, 
the program will exit to desktop. 

10. *PRSET (Load & Run) 

^Preset is a printer utility for setting Epson compatible printers to 
different print modes. Written by Clint Pulley, it was modified 
slightly to auto run and interface with cSHELL99. Press "x" to exit 
the program. 
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11- *TDUMP (Load & Run) (Can replace DUMP on the system disk) 

(Rename to "DUMP" first") 

$Tdump is a screen dump utility for printers without dot addressable 
graphics capability. The printer options window will be displayed 
as in DUMP but the only options available will be Proceed, Screen 
Section and Abort. Any character with a value less than 32 will be 
printed as a period and any character greater than 127 will print as 
an asterisk. The source code will be included to allow a user to add 
options for their printer. To return to cSHELLSS select Abort and 
press the fire button or "Q". 

12. SPEECHBAT (Link fc Run) 

A short speech demo that says "I am a Texas Instruments computer" and 
returns to desktop. 

13. ^SAVEEBOX (Load & Run) (Found on System disk side A) 

$Savebox will save the existing cSHELLSS windows and all active user 
created windows to the system file WIND so that a user need not 
create often used windows with every rerun of the program. All 
windows will retain their current window numbers and characteristics. 
Make sure side A of the System disk is available before pressing 
ENTER when prompted. 

14. *REMOVEBOX (Load & Run) (Found on System disk side A) 

$Removebox will remove all active user created windows from cSHELLSS 
and reset the window pointers to cSHELLSS' s original window 
configuration, If the user created windows were also saved in WIND 
and you want to remove them? after executing this module, load and 
run $Savebox. C source included ) 

15. $LASTBOX (Load & Run) 

$Lastbox will remove the latest user created window from cSHELLSS 
and may be rerun to remove all user created windows one by one. It 
will not remove any of the fourteen original cSHELLSS windows and 
does not access the system file WIND for any permanent changes. 
(Source included). 

IS. *W I MDOW ADD (Load & Run) 

$Windowadd is a utility to allow a user to add their own windows to 
cSHELLSS very easily. It uses the getboxO function to create a 
window from a text file. When prompted type the name of the text 
file containing the window data. Example: DSK2. WINDOW . If 
successful, it will display the number of the window created. The 
newly created window may now be accessed by the returned number in 
user created modules. To save the wmdow/s permanently use the 
$Savebox module as described above. If the window number returned 
is zero, the window was not created. Note that the VDP window area 
and auto catalog grow towards each other and under certain conditions 
one may overwrite a portion of the other. You may use 4034 bytes of 
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window definitions before any possible overwrite caused by a disk 
catalog containing 127 filenames will occur. Each filename entry 
in the auto catalog occupies 12 bytes (see VDP memory map). 

17. *FW (Load & Run) 

$FW is a utility loader which will load the Funl writer environment. 
A window will appear on the screen and prompt for the disk drive 
containing Funl web. Press the appropriate number on the keyboard 
and the Funl web environment will be loaded from the file UTIL1. 
To abort the loading of Funl web f press zero as the disk number- 
Note that to return to cSHELL99 from Funl web you will have to 
select the Funl web program loader #3 and enter DSK#.UTIL5 as the 
filename. Funlweb files are not included with the cSHELL99 
package. 

18. $SAVETEST (Install ) 

$Savetest is a simple demonstration of creating a program image 
module from within the CSHELL99 environment. Install *FIRST, 
$SAVETEST, any c99 libraries (not already included in cSHELL99) that 
you wish, $LAST and #SAVE in that order. When prompted, enter a 
filename to save the program to. Example: DSK#.PROG . After 
returning to the desktop you may run the created program image 
module with the Program Ldr. < See CREATING PROGRAM IMAGE FILES ). 
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SCREEN DUMP MODULE 



On the cSHELL99 system disk side B is a bit image screen printing utility 
called DUMPf written for Epson compatible printers with graphics capability. 
(Source code on MODULES disk side B). It is a relocatable module that will 
load any time the joyst2Q function is called and key #5 is pressed on the 
keyboard. It is accessible when the pointer is being moved around the 
screen by the mmoveO function and also when a window is on the screen in 
menu mode. It also may be loaded and run by using the loadit(strg) 
function. To disable the loading of DUMP in a user created program f set 
the system global "mkeys" to one and before exiting the module set mkeys 
to zero. If you wish to allow for the loading of DUMP by pressing key #5 
from your Load & Run program* execute the system function savptrO to set 
the memory pointers to include your module in the shell (ED/ASSM option #3 
relocatable modules only). 

When DUMP executes it will place a printer options window on the screen for 
your selection. The options are: 

1. Proceed - Begin printing with the specified options. To stop the 
printing process before completion, press the fire button or "Q". 
DO NOT press FCTN/4 to stop the process. 

2. Set Tab - Set the horizontal character position to start the 
printing zone on the page. The tab position must allow for enough 
width left on the line to print the zone selected as determined by 
the mode selected (elite, pica, single density, double density). 

3. Pica - The default mode. Allows for a 480 dot printing zone in 
single density and 960 dot zone in double density. Each character 
in text mode is 6 dots wide and in graphics mode 8 dots (pixels) 
wide. 

4. Elite - Allows for a 576 dot printing zone in single density and 
a 1152 dot zone in double density. 

5. Single Density - The default mode. Sets the print zone to a 
maximum of 480 dot in pica mode and 576 dots in elite mode. This 
mode prints using every other pin on the print head. 

6. Double Density - Sets the print zone to a maximum of 960 dots in 
pica mode and 1152 dots in elite mode. This mode will print using 
all the pins on the print head. 

7. Screen Section - This option allows the user to select the portion 
of the screen that will be printed. It may range from one character 
to the entire screen. The pointer will appear in the upper left 
corner of the screen. (Some monitors will not show this position 

in graphics mode). Move the pointer to the upper left corner of 
the section you want to print and press the fire button once. After 
the pointer flickers, move the pointer to the lower right corner of 
the desired section and press the fire button once. The rectangular 
area between the first and second selection will be printed as 
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designated by the options selected when you select Proceed. The 
default print area is the entire screen. 

8. Abort - Exits the printing module and returns to the calling function 
(CSHELL99). 

Before each printing the options must be selected or the default values will 
be in effect. They are Tab=l f Pica mode f Single Density f and the entire 
screen will be printed. 

Note: The screen dump utility may now be used in graphics mode and text mode 
in the same manner and will adjust itself to print characters of six or eight 
pixel widths. 

An easier explanation of the printing utility is that you may select any part 
of the screen to be printed at a selected line position in any one of four 
different sizes. 
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c99 SOUND L_ I BRARY 



This sound library is used with the c99 compiler by Clint Pulley and was 
created by Joe Ross. 

To use this library with your C programs you must include the file SOUNDLIB 
in your program. Example: #include "DSK1 . SOUNDLIB" . You must also load the 
relocatable library "SOUNDS" when you run your program with the Load and Run 
option on the Editor Assembler. 

This library consist of five sound functions sounda f soundn? soundly sound2 f 
and sounds. The reason for breaking the sound command into five functions is 
to save program space by using only the function needed instead of having to 
pass all the parameters to one larger function. 

The frequencies that may be used are the same as in Basic with the highest 
frequency being 32567 and the lowest being 110. The duration rate for the 
sound is from 1 - 4250 with each multiple of 18 equal to l/60th of a second. 
The value 1000 would enable sound for one second as in Basic with 500 as a 
half a second etc... Note that a negative duration value can be used with 
this version. The only difference is that the attenuation (loudness) uses the 
values of 0 - 15 instead of 0 - 28 as in Basic. A value of 0 would be the 
loudest sound and 15 would turn off that particular generator. 
The noise values -1 through -8 are the same as in Basic with the exception 
that they may also be positive values 1-8. All parameters must be passed in 
each function and must be in the proper order as specified by the function. 
If you don't want a particular generator to sound? pass a zero value to the 
frequency or noise and a value of 0 to its respective attenuation. All 
parameters may be integers or integer variables. 



FUNCTIONS IIM SOUNDS 



This function will produce one tone. 

sound 1 (dur, freq* attn) ; 

This function will produce two tones. 

sound2 (dur , freq,attn f freq2 f attn2) ; 

This function will produce three tones. 

sound3 (dur, freq f attn f freq2»attn2 f f req3* attn3) ; 

This function will produce three tones and a noise. 

soumdaiCdurf freq» attn» freq2,attn2 f freq3 f attn3 f noise,attn4) j 

This function will produce a noise only. 

Boundn (dur ,noise f attn) j 
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Gf33 Sp^^ch Function 



This speech function was designed by Joe Ross to be used with CSS created 
by Clint Pulley. To use this function with your "C" program you must include 
the statement #extern speech O in your source module. Also you must load 
"SPEECH'S the relocatable function? when you use the ED/ASSM Load and Run 
option to run your program. 



The following is a list of all letters* numbers* words and phrases that can be 
accessed by a "C" program using the function s^yCaddr); . This list is 
made of the standard words that can be accessed by the speech synthesizer. 
The address is passed as a decimal integer /variable. Example: say(8244); will 
make the computer say the word "computer". 



Address Phrase 



Address Phrase 



18652 


- (Negat 


20716 


. (Point 


512S 


1 


5274 


3 


5425 


5 


5608 


7 


5732 


s 


5860 

www " 


A (ay) 


5908 


about 


6053 


aaain 


61S2 


am 


DO lb 


ana 


6498 


any 


6567 


as 


6693 


at 


6722 


B 


6799 


base 


6878 


between 


7050 


blue 


7146 


bottom 


7240 


buy 


7240 


bye 


7302 


C 


7440 


cassette 


7554 


check 


7654 


clear 


7764 


come 


7902 


comma 


8049 


complete 


8244 


computer 


8435 


console 


8578 


course 



20915 
5059 
5212 
5351 
5544 



5888 



6151 

6262 
6413 
21870 
6632 



6756 
6722 
6S83 
70S4 
7200 
7240 



74S5 
7586 
7712 
7815 



8141 
8331 
8508 
8640 



+ (Positive) 

0 

2 

4 

6 

8 



Al (uh) 
after 
all 
an 

answer 
are 



back 
be 

black 
both 
but 
by 



can 

center 
choice 
color 



command 

completed 

connected 

correct 

cyan 
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8707 D 8764 

8852 decide 8957 

9062 did 9156 

9261 diskette 9344 

9395 does 9450 

9534 done 9625 

9683 down 9746 

9832 drawing 

9931 E 9968 

5687 eight 10019 

10073 eleven 10166 

10229 end 10342 

10413 enter 10479 

10655 F 10690 

10781 fifty 10848 

10967 find 11038 

11099 finish 11156 

11223 first 11284 

5425 five 5351 

11326 forty 5351 

11391 fourteen 11545 

11636 from 11708 

11755 6 11816 

11916 get 11962 

12088 give 12173 

12284 go 12337 

12409 going 12502 

12538 good work 12616 

12704 got 12753 

12829 green 12926 

12992 H 13039 

13113 hand 13183 

13317 has 13386 

13452 head 13541 

13594 hello 13681 

13541 here 13742 

13834 hit 13886 

13961 how 14063 

14167 hurry 

14227 I 14287 

14416 i f 14450 

14517 inch 14586 

14667 instruction 14781 

14898 is 14970 

15022 J 15085 

15180 just 



data 
device 
different 
do 

doing 

double 

draw 



each 

eighty 

else 

ends 

error 

f i fteen 

figure 

fine 

finished 

fit 

for 

four 

fourth 

front 

games 

getting 

gives 

goes 

good 

goodbye 

gray 

guess 

had 

handheld unit 

have 

hear 

help 

higher 

home 

hundr ed 



I win 
in 

inches 

instructions 
it 

joystick 
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15242 
15337 

15503 
15641 
1583B 
15992 
16136 
16234 
16459 
16701 
16871 



K 

keyboard 
L 

larger 



left 

let 

likes 

load 

look 

lower 



15289 
15439 

15568 
15719 
15902 
16050 
16175 
16341 



16785 



key 
know 

large 

largest 

learn 

less 

like 

line 

long 

looks 



16947 
17070 
17277 
17413 
17623 
17811 
17986 
18143 



M 

magenta 
me 

memory 

messages 

might 

more 

move 



16999 
17198 
17341 
17516 
17745 
17887 
18067 
18237 



made 

make 

mean 

message 

middle 

modul e 

most 

must 



18310 
18483 
18652 
18853 
19022 
19115 
19232 



N 

near 

negative 
nice try 
ninety 
not 

number 



18368 
18560 
18777 
5732 
15439 
19162 



name 

need 

next 

nine 

no 

now 



19325 
19475 
19521 
19595 
19764 
19924 



0 

off 
on 

only 

order 

out 



19325 
5129 
19676 
19850 
19978 



of 
oh 
one 
or 

other 
over 



20070 
20192 
20353 
20525 
20716 
20915 
21101 
21241 
21486 
21674 

21792 



P 

partner 

period 

plays 

point 

positive 

print 

problem 

program 

putting 

0 



20127 
20273 
20453 
20627 
20808 
21041 
21162 
21344 
21623 



part 

parts 

play 

please 

position 

press 

printer 

problems 

put 



21870 
22098 
22195 
22465 



R 21920 

read (reed) 22465 

ready to start 22341 

red 22529 



randomly 
readl (red) 
recorder 
refer 
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22625 


remember 


22735 


return 


22842 


rewind 


31800 


right 

mm 


22978 


round 






23130 


S 


23201 


said 


23279 


save 


23397 


say 


23458 


says 


23547 


screen 


23643 


second 


7302 


see 


23743 


sees 


23835 


set 


5608 


seven 


23888 


seventy 


23973 


shape 


24030 


shapes 


24103 

mm* ■ mm m mmm 


shi ft 


24156 


short 


24229 


shorter 


24356 


should 


24429 


side 


24520 


sides 


5544 


six 


24602 


sixty 


24688 


small 


24750 


smaller 


24817 


smal 1 est 


24915 


so 


24983 


some 


24030 


sorry 


25126 


space 


25181 


spaces 


25292 


spell 


25395 


square 


25468 


m m 

start 


25541 


step 


25591 


stop 


24983 


sum 


25635 


supposed 


25737 


supposed to 


25844 


sure 






25937 


T 


25995 


take 


26047 


teen 


26115 


tell 


26190 


ten 


26262 


texas instruments 


26459 


than 


26550 


that 


26646 


that is incorrect 26878 


that is right 


26996 


the (thee) 


27062 


thel (thuh) 


27250 


their 


27105 


then 


27250 


there 


27358 


these 


27463 


they 


27552 


thing 

mm 


27663 


things 


27763 


think 


27836 


third 


27921 


thirteen 


28066 


thirty 


28126 


this 


5274 


three 


28198 


threw 


28198 


through 


28265 


time 


5212 


to 


28336 


together 

mW 


28447 


tone 


5212 


too 


28557 


top 


28603 


try 


28687 


try again 


28818 


turn 


28878 


twelve 


28953 


twenty 


5212 

lw mm* mm mm* 


two 


29040 


type 


29118 


U 


29172 


uhoh 


29253 


under 


29341 


understand 


29487 


until 


29599 


up 


29635 


upper 


29699 


use 


29769 


V 


29831 


vary 


29914 


very 







K.4 



« 



29984 
30175 
30384 
30384 
30487 



30837 
30964 
31081 
31249 
5129 
31498 
31676 



W 

want 

way 

weigh 

well 

what 

when 

which 

who 

will 

won 

words 

working 



30109 
30241 
30333 
30109 
30556 
30697 
30891 
31012 
31156 
31339 
31403 
31605 
31800 



wait 

wants 

we 

weight 
were 

what was that 

where 

white 

why 

with 

word 

work 

write 



31885 



31922 
32088 
29118 



Y 

yes 
you 
your 



31992 
32153 
32219 



yellow 
yet 

you win 



32409 



5059 



zero 



LOW MEMORY USAGE BY CSHELL99 



Dec i mal 



HEX 



8192 



>2000 



Ed/Assm Utilities 



9846 



>2676 



l 
I 

I 
I 



Low Memory Program Sp 
C Grows upward ) 



14638 



Initial c Stack Position 
(Grows downward ) 



>392E 



16383 



i 
i 

i 
i 



REF/DEF Table 
(Grows downward > 



>3FFF 



AP. 1 



VDP RAM USAGE BY <= SHELLS9 I IM TEXT MODE 



Decimal Hex 

0 >0000 

Screen Image Table 

960 >03C0 

Free Space & Sprite Descriptor Block 

( Experiment ) 

1920 >0780 

Sprite Motion Table 
( Experiment ) 

2048 it:*$$g*:Mtf$^ >0800 

Pattern Generator Table (Chars 0-31) 
< Used by the Desktop screen ) 

2304 >0900 

Standard Characters < Chars 32-127 ) 

3072 >OCO0 

Chars 128-135 Window Borders 
Chars 136-144 ( Free ) 

3208 >0C88 

Inverse Video Characters 
Chars 145-239 



> O F80 

Chars 240-255 ( Free ) 
4096 ttttttt.^ > 1 000 

Used for desktop screen swapping. 960 bytes 

5056 >13C0 

Temporary save of character def. 0-239 

6978 MB42 

Sound Library VDP Buffer 

7024 >1B70 

CFI0 & TCI0 PABS & Buffers 

8 1 92 >2000 

i 
i 

S Dialog Boxes Buffer 

v ( Grows upward in memory > 



I Automode Disk Catalog Storage Buffer 
S < Grows downward in memory ) 

1 3394 fc***'**:*****^ >3452 

loaditO & binfilO PAB area 

13442 >3482 

loaditO VDP Input Buffer 

14303 >37DF 

Diskette DSR Blocks 
16383 >3FFF 
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I L_E I /O ERRORS 



Meaning 



Standard I/O 



Bad device name. 

Device is write protected. 

Bad open attribute ( incorrect file type, incorrect record 
length, incorrect I/O mode or no records in a relative file > 

Illegal operation. 

Out of table or buffer space on the device. 
Attempt to read past the end of file. 
Device error. 

File error ( non-existing file opened in INPUT mode ). 
_ 

Loader Errors 



Memory overflow 
Not used. 
Illegal tag. 
Checksum error. 
Duplicate definitions. 
Unresolved reference. 
Incorrect statement 
Program not found. 
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VAR I ABLE «< FUNCTION GLOBALS 

The following is a list of all global variables and function 

names that are on the REF/DEF table during the execution of cSHELL99. 

CSUP v 
C$IND, C$DIV, C*REM, C*ASR, C*ASL, C*EQ, C*NE, C*LT, C*LT, C$GT, 
C*GE, C*ULT, C*ULE, C*UGT, C*UGE, C$LNE6, C*SWCH, GETCH, GETS, PUTCHA, 
PUTS, LOCATE, POLL, TSCRN, C*SEND, C*CLS, C*FILL, C$VADR, CfSTRT, 
S*SEND, S*WDTH, CSC ALL, CtGPLL, C*CTFL, CtPGRA, C*SGRA, CtHOOK 

CFIO 

FOPEN, FCLOSE, GETC, PUTC, FGETS, FPUTS, FREAD, FWRITE, FSEEK, 

FDELETE, FERRC, FEOF, REWIND 
EDITOR/ASSEMBLER UT ILITI ES 

VSBW, VMBW, VSBR, VMBR, VWTR, KSCAN, GPLLNK, XMLLNK, DSRLNK, 

LOADER, SCAN, ULTAB, PAD, GPLWS, SOUND, VDPWA, VDPRD, VDPWD, VDPSTA 

GRMWA, GRIiRA, GRMRD, GRMWD 
cz SHELL99 

MOUSE, CROW, CCOL, SCHAR, CSPEED, CTOP, CBOT, CLEFT, CRIGHT, J0YST2, 
GETVDP, PUTVDP, MMOVE, LOAD IT, SAVPTR, RTNPTR, FHI, FLOW, LHI, LLOW, 
SYSAR1, RWERR, START, DELAY, JWAIT, PRINTER, DSK, FNAME, COMFLG, 
FORG, BACKG, UPPER, STRCPY, PUTBOX, ENDBOX, IVIDEO, BOXNUM, BOXPOS, 
BOXPTR, MENU, BOXDTA, CLBOX, BXTEXT, SNGETS, PARM2, RDLIN, WRTLIN, 
AATOI, IITOD, BATCH, SYSAR2, REMOVE, BINFIL, DOIT, CINDEX, CATIN, 
CSTART, RCOUNT, SETVAR, MKEYS, MINDIR, MODNUM, MODULE, LOADST, SWAP1, 
SWAP2, AUTFLG, SINGLE 
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STACK REF/DEF TABLE 



The c99 stack area and link loader REF/DEF table both exist at >3FFF 
and grow downward towards >2000 in low memory. Under normal configurations, 
it is not possible to use the linking loader from within a c99 program and 
reference labels from the table if the stack is used. The stack overwrites 
the table thus wiping out the address links. To overcome this problem I 
simply moved where the c99 stack resides. The address of the stack 
pointer is in R14 ( workspace register 14 ) . To move it include in your 
mainO function, as the first command, an assembler instruction to load R14 
to the address you desire. I moved the stack to >392E C 1744 bytes lower 
in low memory ) enough for 218 labels on the REF/DEF table. Of course 
this move lessens the amount of memory available to the stack but the 
stack area grows and shrinks with the entry and exit of functions. There 
is still over 4.6K left for the stack before a crash into the utilities 
would occur. This setup leaves little room for programs to load in low 
memory but enables the linking loader to be used within a shell program 
thus allowing for greater programming power. See LINKING LOADER for a 
further description of the loading process. An example of moving the c99 
stack is as follows: 



/* Relocating the c99 stack */ 

mainO 

I 

#asm 

LI 14 f >392E c99 doesn't use R before registers. 
#endasm 

int 5 /* The rest of mainO */ 

char : 



> 



If you are using cSHELL99 this procedure has aready been executed and should 
NOT be repeated. This information has been provided to enable the use of the 
linking loader from within your own program should you choose to write one 
from scratch. 

NOTE: Using the above assembly instruction in mainO may generate an 

"OUT OF CONTEXT" message as the program is compiled. Just ignore the 
message because the right assembler code is generated. 
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CSHELL99 CHARACTER DEFINITIONS 



CHAR PATTERN DESCRIPTION 



1 


0078605048040000 


Pointer 


2 


0404040404040404 


Left boader 


3 


8080808080808080 


Right boarder 

mm 


4 


FF80808080808080 


Menu divider 


5 


FF04040404040404 


Upper right corner 


6 


FF00000000000000 


Top border 

• 


7 


00000000000000FF 


Bottom border 


8 


04040404040404FF 


Lower right corner 


9 


844444241 4 140C04 


Bottom corner of flap 


10 


FF804020 10 100804 


Top left flap 


11 


COCOCOCOCOCOCOCO 


Right shadow 


12 


FFFF000000000000 


Bottom shadow 


13 


COCOOOOOOOOOOOOO 


Corner shadow 


14 


FF00FF00FF00FF00 


Striped top 


15 


000000FF00FF00FF 


Striped bottom 


16 


FF80809C9C8080FF 


Left side of disk button 


17 


FF0404E4E40404FF 


Right side of disk button 


18 


7F7F787070787F7F 


Disk icon 


19 


7F7F7F7F 00000000 




20 


FFFF38 181 F3FFF7F 




21 


7F7FFFFF00000000 




22 


047FFF4070787878 


Trash icon 


23 


78787878787878FF 




24 


80F8FF08A8A8A8A8 




25 


A8A8A8A8A8A8A8FF 




26 


0000047FFF7F407F 


Printer icon 


27 


00000000 1 F24405F 




28 


00000000FF88 1 0D0 

V V WWW! I UU X vMJv 




29 


102040F8FFF808F8 




30 


409F00FFFFFF00FF 




31 


80808080808080FF 


Bottom left corner 




HI— RES BORI 


)ER CHARACTERS 


128 


FFFFD0FFD0D0D0D0 


upper left corner 


129 


FFFF00FF00000000 


Top Line 


130 


FFFF2FFF2F 2F2F2F 


upper right corner 


131 


D0D0D0D0D0D0D0D0 


left side 


132 


2F2F2F2F2F2F2F2F 


Right side 


133 


D0D0D0D0FFD0FFFF 


Bottom left 


134 


00000000FF00FFFF 


Bottom line 
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